home *** CD-ROM | disk | FTP | other *** search
Text File | 1988-08-16 | 50.2 KB | 1,160 lines |
- Kermit is a file transfer program. It allows the transfer
- of files over terminal lines from a remote Kermit program to
- the local Kermit program.
-
- Kermit-10 can be run in either local or remote modes. In
- remote mode, transfers take place over the controlling
- terminal line. Ususally, Kermit-10 is used in remote mode
- as a "server", meaning that it will accept commands from the
- other Kermit. In local mode, Kermit-10 will perform
- transfers over a terminal line other than the controlling
- terminal. In local mode, Kermit-10 is capable of giving
- commands to a "server" Kermit. Kermit-10 is put into local
- mode by using the SET LINE command.
-
- Type HELP <command> for more information on a given
- commands. Additional information is avaiable for:
-
- BYE CONNECT EXIT FINISH GET LOCAL
- LOG LOGOUT RECEIVE REMOTE SEND SET
- SHOW STATUS
-
- *BYE
- BYE This command will cause Kermit-10 (when in local mode) to
- tell the other Kermit (which should be in server mode) to
- exit from Kermit and, if applicable, terminate its job (or
- process, etc.). When Kermit-10 receives the acknowledgement
- that this is being done, it will exit to TOPS-10.
-
- Kermit-10>BYE
-
-
- *CONNECT
- CONNECT The CONNECT command will allow you to connect in as a
- virtual terminal over the line that was specified by the SET
- LINE command, or to the terminal line specified in the
- command. The format of the CONNECT command is:
-
- Kermit-10>CONNECT
-
- or
-
- Kermit-10>CONNECT device:
-
- where device: is the terminal name to be used.
-
- or
-
- Kermit-10>CONNECT node:: line
-
- where node:: is the node number the terminal is attach to,
- and line is the line number within that node.
-
- *EXIT
- EXIT The EXIT command will cause Kermit to return to command
- level. This command is the same as the QUIT command. An
- example of this command is:
-
- Kermit-10>EXIT
-
- *FINISH
- FINISH This command will cause Kermit-10 (when in local mode) to
- tell the other Kermit (which should be in server mode) to
- exit from Kermit. After receiving the acknowledgement that
- this is being done, Kermit-10 will prompt for another
- command.
-
- Kermit-10>FINISH
-
-
- *GET
- GET This command can only be used in local mode. It will cause
- Kermit-10 to request that the other Kermit (which must be
- running in server mode) to transmit the specifed file(s) to
- Kermit-10.
-
- Kermit-10>GET file-specification
-
- Where "file-specification" is a valid file specification for
- the system on which the other Kermit is running.
-
- *LOCAL
- LOCAL This set of commands performs actions like getting directory
- listings, deleting files, etc., on the local system (i.e.,
- the system Kermit-10 is running on). These commands
- correspond to the commands which Kermit-10 implements in
- server mode.
-
- Additional information is available for the LOCAL commands
- by typing HELP LOCAL <option>, where option is one of the
- following:
-
- CWD DELETE DIRECTORY DISK-USAGE
- ERASE HELP SET-PATH SPACE
- STATUS TYPE
-
- *LOCAL CWD
- LOCAL CWD This command is used to change the current default path for
- the job running Kermit. The CWD stands for "change working
- directory". The command takes a path specification as an
- argument. If no argument is given, the default path is set
- to the path which was in effect when Kermit-10 was run.
- This command is identical to the LOCAL SET-PATH command.
-
- Kermit-10>LOCAL CWD
-
- Kermit-10>LOCAL CWD path-specification
-
- Where "path-specification" is any valid TOPS-10 path
- specification.
-
- *LOCAL DELETE
-
- LOCAL DELETE This command is used to delete a file or set
- of files. It takes a single, possibly wildcarded, file
- specification as an argument. All files which match the
- specification are deleted. As the files are deleted, the
- names and sizes are printed out. This command is the same
- as the LOCAL ERASE command.
-
- Kermit-10>LOCAL DELETE file-specification
-
- Where "file-specification" is any valid TOPS-10 file
- specification. Wildcards are allowed.
-
- *LOCAL DIRECTORY
-
- LOCAL DIRECTORY This command will list all files which match
- the wildcard file specification which is supplied as its
- argument. If no argument is given, it will list all files
- from the current default path. The file names, sizes (in
- words and allocated blocks) and creation dates are listed.
-
- Kermit-10>LOCAL DIRECTORY file-specification
-
- Where "file-specification" is any valid TOPS-10 file
- specification (wildcards allowed). If "file-specification"
- is left out, Kermit-10 uses "*.*".
-
- *LOCAL DISK-USAGE
-
- LOCAL DISK-USAGE This command reports the amount of disk space
- in use and available. It takes optional arguments of either
- a structure name, a PPN, or both. If no argument is
- supplied, the disk usage and quota information is displayed
- for the user's PPN on all structures currently mounted by
- the job running Kermit-10. If only a PPN is supplied, the
- quota and disk usage information is displayed for that PPN
- on all structures currently mounted. If only a structure
- name is given, the disk usage and quota information is
- listed for the user's PPN on that structure. If both a PPN
- and structure name are given, Kermit-10 displays the quota
- and disk usage information for that PPN on the given
- structure. The information provided is similar to that
- provided by QUOLST. This command is the same as the LOCAL
- SPACE command.
-
- Kermit-10>LOCAL DISK-USAGE structure:ppn
-
- Where "structure" is a valid structure name (or null for all
- structures in the jobs search list), and "ppn" is a valid
- project-programmer number (enclosed in square brackets) or
- null to use the user's PPN.
-
- *LOCAL ERASE
-
- LOCAL ERASE This command is used to delete a file or set
- of files. It takes a single, possibly wildcarded, file
- specification as an argument. All files which match the
- specification are deleted. As the files are deleted, the
- names and sizes are printed out. This command is the same
- as the LOCAL DELETE command.
-
- Kermit-10>LOCAL ERASE file-specification
-
- Where "file-specification" is any valid TOPS-10 file
- specification. Wildcards are allowed.
-
- *LOCAL HELP
-
- LOCAL HELP This command will display the help message
- which is returned when Kermit-10 receives a generic help
- request in server mode. It describes the functions which
- are implemented in server mode by Kermit-10.
-
- Kermit-10>LOCAL HELP
-
- *LOCAL SET-PATH
- LOCAL SET-PATH This command is used to change the current
- default path for the job running Kermit. The command takes
- a path specification as an argument. If no argument is
- given, the default path is set to the path which was in
- effect when Kermit-10 was run. This command is identical to
- the LOCAL CWD command.
-
- Kermit-10>LOCAL SET-PATH
-
- Kermit-10>LOCAL SET-PATH path-specification
-
- Where "path-specification" is any valid TOPS-10 path
- specification.
-
- *LOCAL SPACE
-
- LOCAL SPACE This command reports the amount of disk space
- in use and available. It takes optional arguments of either
- a structure name, a PPN, or both. If no argument is
- supplied, the disk usage and quota information is displayed
- for the user's PPN on all structures currently mounted by
- the job running Kermit-10. If only a PPN is supplied, the
- quota and disk usage information is displayed for that PPN
- on all structures currently mounted. If only a structure
- name is given, the disk usage and quota information is
- listed for the user's PPN on that structure. If both a PPN
- and structure name are given, Kermit-10 displays the quota
- and disk usage information for that PPN on the given
- structure. The information provided is similar to that
- provided by QUOLST. This command is the same as the LOCAL
- DISK-USAGE command.
-
- Kermit-10>LOCAL SPACE structure:ppn
-
- Where "structure" is a valid structure name (or null for all
- structures in the jobs search list), and "ppn" is a valid
- project-programmer number (enclosed in square brackets) or
- null to use the user's PPN.
-
- *LOCAL STATUS
-
- LOCAL STATUS This command will type out the status
- information since Kermit-10 was started. This is the same
- as the totals information that is printed by the STATUS
- command.
-
- Kermit-10>LOCAL STATUS
-
- *LOCAL TYPE
-
- LOCAL TYPE This command will type a file or files on the
- user's terminal. It takes a file specification (possibly
- wildcarded) as an argument. This file is read using the
- current BYTE-SIZE, so it is possible to type a file which
- was stored using BYTE-SIZE EIGHT.
-
- Kermit-10>LOCAL TYPE file-specification
-
- Where "file-specification" is any valid TOPS-10 file
- specification. Wildcards are permitted.
-
- *LOG
- LOG This set of commands is used to specify the names of various
- types of log files. Each command either specifies the name
- of the given type of log file, or clears the name. For more
- information type HELP LOG <option>, where option is one of:
-
- DEBUG SESSION
-
- *LOG DEBUG
- LOG DEBUG This command sets the name of the debugging log file to be
- used during transfers. This log file is used for debugging
- output when the SET DEBUG ON command is used. A new file by
- the given name will be created, unless the /APPEND switch is
- used. After the file has been created, subsequent transfers
- will append to the file. Note that the SET DEBUG LOG-FILE
- file-name command is equivalent to LOG DEBUG
- file-name/APPEND followed by a SET DEBUG ON command.
-
- Kermit-10>LOG DEBUG file-specification
-
- or
-
- Kermit-10>LOG DEBUG file-specification/APPEND
-
- Where "file-specification" is a valid TOPS-10 file
- specification.
-
- *LOG SESSION
- LOG SESSION This command sets the name of the log file to
- be used during "CONNECT" sessions. This file is used to log
- all characters which are output to the user's terminal when
- the CONNECT command is being used to perform terminal
- emulation. A new file by the given name will be created,
- unless the /APPEND switch is used. In any case, once the
- file has been created, subsequent CONNECTs will append to
- the file.
-
- Kermit-10>LOG SESSION file-specification
-
- or
-
- Kermit-10>LOG SESSION file-specification/APPEND
-
- Where "file-specification" is a valid TOPS-10 file
- specification.
-
- *LOGOUT
- LOGOUT This command will cause Kermit-10 (when in local mode) to
- tell the other Kermit (which should be in server mode) to
- exit from Kermit and, if applicable, terminate its job (or
- process, etc.). When Kermit-10 receives the acknowledgement
- that this is being done, it will prompt for another command.
-
- Kermit-10>LOGOUT
-
-
- *QUIT
- QUIT This command will cause Kermit to return to command level.
- This is the same as the EXIT command.
-
- Kermit-10>QUIT
-
- *RECEIVE
- RECEIVE The RECEIVE command is used to put Kermit-10 into remote
- mode waiting for a single file transfer transaction. If no
- file specification is given, Kermit-10 will wait for a file
- transfer initialization sequence from the other Kermit. If
- a file specification is given, that file specification will
- be used to store the received file(s), regardless of what
- name is supplied by the other Kermit.
-
- The format of the command is:
-
- Kermit-10>RECEIVE
-
- or
-
- Kermit-10>RECEIVE file-specification
-
- Where "file-specification" is any valid TOPS-10 file
- specification.
-
- *REMOTE
- REMOTE This command allows the user of Kermit-10 (in local mode) to
- give various commands to the other Kermit (which must be in
- server mode). These commands provide for listing the
- contents of a directory, deleting files, typing files,
- displaying the amount of disk space used, etc. Note that
- not all server Kermits support all commands, but all server
- Kermits should repsond with a message saying the command is
- not implemented if it does not support it.
-
- Kermit-10>REMOTE keyword arguments
-
- Where keyword is the name of the command, and arguments are
- the optional arguments for the command.
-
- For more information on the individual commands, type "HELP
- REMOTE option", where "option" is one of:
-
- COPY CWD DELETE DIRECTORY
- DISK-USAGE ERASE EXIT HELP
- HOST LOGIN LOGOUT RENAME
- SEND SPACE STATUS TYPE
- WHO
-
- *REMOTE COPY
- REMOTE COPY This causes Kermit-10 to request that the
- server Kermit make a copy of the specified file. Both the
- old and new files are files on the server's system - no file
- transfer between systems is done. The server Kermit should
- respond with some indication that either the file was
- successfully copied, or with an error message. Note that
- some Kermit's will allow wild-carded copies, while others
- will only allow a single file to be copied per command.
-
- Kermit-10>REMOTE COPY old-remote-file
- New file: new-remote-file
-
- Where 'old-remote-file' is the name of the file you wish to
- copy, and 'new-remote-file' is the name for the copy.
-
- *REMOTE CWD
- REMOTE CWD This command (short for "Change Working
- Directory") causes Kermit-10 to request that the server
- Kermit change the default directory (path, device, etc.)
- that will be used for files whose specification does not
- include the directory information. For some systems a
- password can be supplied which will allow access to the new
- directory. Since Kermit-10 can not know whether the server
- Kermit requires a password, it will always ask for one. If
- no directory is specified in the command, the server Kermit
- will set the default directory back to the users default.
- This may be either the directory which is the default when a
- job created, or the default directory which was in effect
- when the server Kermit was started. The server Kermit
- should respond with a message which indicates where the new
- default directory has been set, or with an error message.
-
- Kermit-10>REMOTE CWD
- remote-directory-specification
- Password: password for remote directory
-
- or
-
- Kermit-10>REMOTE CWD
-
- Where 'remote-directory-specification' is a string which is
- acceptable as a directory indication for the server system.
- The password is any string which is required as a password
- for access to the given directory. The password will not be
- echoed.
-
- *REMOTE DELETE
- REMOTE DELETE This causes Kermit-10 to request the server
- Kermit to delete the specified file (or files if the server
- Kermit supports wild-card deletes). The server Kermit
- should respond with a message indicating whether the file
- (or files) has been deleted. This is the same as the REMOTE
- ERASE command.
-
- Kermit-10>REMOTE DELETE file-specification
-
- Where file-specification is a valid file specification for
- the server Kermit's system.
-
- *REMOTE DIRECTORY
- REMOTE DIRECTORY This causes Kermit-10 to request a directory
- listing from the server Kermit. The directory listing will
- be printed on the users terminal. The format of the listing
- is determined by the server Kermit.
-
- Kermit-10>REMOTE DIRECTORY file-specification
-
- Where the file-specification is an optional valid file
- specification for the server Kermit's system.
-
- *REMOTE DISK-USAGE
- REMOTE DISK-USAGE This causes Kermit-10 to request the server
- Kermit to reply with an indication of the amount of disk
- space used and available for the given directory (or the
- default directory if none is given). This is the same as
- the REMOTE SPACE command.
-
- Kermit-10>REMOTE DISK-USAGE
- directory-specification
-
- Where directory-specification is an optional directory
- specification for the server Kermit's system.
-
- *REMOTE EXIT
- REMOTE EXIT This command is identical to the FINISH
- command. It requests the server Kermit to exit to its
- system command parser, allowing the terminal to be used for
- normal commands.
-
- Kermit-10>REMOTE EXIT
-
-
- *REMOTE HELP
- REMOTE HELP This causes Kermit-10 to request the server
- Kermit to reply with a sort summary of what commands it
- supports in server mode. If an argument is given, help on
- the specific topic is requested. The resulting help message
- will be typed on the users terminal.
-
- Kermit-10>REMOTE HELP topic
-
- or
-
- Kermit-10>REMOTE HELP
-
- Where topic is an option subject for more detailed help. If
- no topic is given, a general help message is requested.
-
- *REMOTE HOST
- REMOTE HOST This command requests the server Kermit to
- perform the specified command as if it were typed by the
- user on a terminal. Any results of the command will be
- printed on the user's terminal. Note that this should only
- be used for commands which will not require any more user
- input, since there will be no way for the user to interact
- with the remote system to supply more input.
-
- Kermit-10>REMOTE HOST command
-
- Where 'command' is any valid command to be processed by the
- remote systems standard command parser.
-
- *REMOTE LOGIN
- REMOTE LOGIN This command allows the user to supply the
- server Kermit with accounting information. The server
- Kermit may use this to validate the users access to the
- system as well as for billing purposes. It may also use
- this information to provide the user with access to files on
- its system.
-
- Kermit-10>REMOTE LOGIN user-id
- Account: remote-accounting-info
- Password: remote-password
-
- Where 'user-id' is a string which represents a valid user
- identification on the remote system,
- 'remote-accounting-info' is any additional accounting
- information required by the remote system (such as account
- strings), and 'remote-password' is the password for the
- remote system which corresponds to the given user-id. The
- password will not be echoed.
-
- *REMOTE LOGOUT
- REMOTE LOGOUT This command is the same as the LOGOUT
- command. It will request the server Kermit to exit and
- logout its job.
-
- Kermit-10>REMOTE LOGOUT
-
-
- *REMOTE RENAME
- REMOTE RENAME This command causes Kermit-10 to request that
- the server Kermit change the name on a file. The server
- Kermit should respond with an indication that the operation
- is completed successfully, or else with an error message.
- Some Kermit's may allow wild-card file specifications to be
- used, and will repsond with a list of files and new names.
-
- Kermit-10>REMOTE RENAME old-remote-file
- New file: New-remote-file
-
- Where 'old-remote-file' is the name of the file to be
- renamed, and 'new-remote-file' is the new name for the file.
-
- *REMOTE SEND-MESSAGE
- REMOTE SEND-MESSAGE This command requests the server Kermit to
- send a short (one line) message to the given destination.
- Depending on the system, the destination may be a terminal,
- a user name, a mailbox name or some other destination
- address. The server Kermit should respond with an
- indication of success or failure.
-
- Kermit-10>REMOTE SEND-MESSAGE destination-address
- Message: message-text
-
- Where 'destination-address' is a valid destination for the
- server's system, and 'message-text' is the message to be
- sent.
-
- *REMOTE STATUS
- REMOTE STATUS This requests the status of the server
- Kermit. The server Kermit will reply with some indication
- of its status.
-
- Kermit-10>REMOTE STATUS
-
-
- *REMOTE TYPE
- REMOTE TYPE This causes Kermit-10 to request the server
- Kermit to transmit the specified file (or files if the
- server supports wildcards) so that the file(s) can be typed
- on the users terminal.
-
- Kermit-10>REMOTE TYPE file-specification
-
- Where file-specification is a valid file specification for
- the server Kermit's system.
-
- *REMOTE WHO
- REMOTE WHO This requests the server Kermit to display a
- list of users of its system, along with other information
- about the users and/or system. A specific user-id may be
- supplied, which may result in more detailed information
- about the particular user. It is also possible to supply
- options for use by the server Kermit in determining the
- format, etc., of the resulting list.
-
- Kermit-10>REMOTE WHO user-id
- Options: options-list
-
- Where 'user-id' is an optional string representing a
- specific user, and 'options-list' is an optional list of
- formatting or selection options.
-
- *SEND
- SEND The SEND command will allow you to send a file(s) to the
- other Kermit. If Kermit-10 is running in remote mode, the
- file will be sent on the controlling terminal line after
- waiting the number of seconds specified by the SET DELAY
- command. This gives the user time to escape back to the
- other Kermit and issue a receive command. If Kermit-10 is
- running in local mode, the file will be sent immediately on
- the terminal line specified by the SET LINE command.
-
- The command format is:
-
- Kermit-10>SEND file-specification
-
- Where "file-specification" is any normal TOPS-10 file
- specification. Any portion of the file specification
- (except the device) may be wildcarded. Note that the single
- wild-card character is indicated by a % instead of the
- usualy ?, since ? is used to obtain help.
-
- *SERVER
- SERVER This command will cause Kermit-10 to enter server mode. The
- other Kermit can then issue server commands to send and
- receive files without having to give SEND or RECEIVE
- commands to Kermit-10. Kermit-10 may be put into SERVER
- mode while running as either a remote Kermit (transmitting
- over the controlling terminal line), or as a local Kermit
- (transmitting over a terminal specified by a SET LINE
- command). Note that in order to correctly receive binary
- files while in SERVER mode, a SET FILE BYTE-SIZE EIGHT-BIT
- must be done first. At this time there is no way for
- Kermit-10 to determine whether an incoming file is ASCII or
- binary. Kermit-10 does make an attempt to guess whether a
- file being sent is ASCII or binary if a SET FILE BYTE-SIZE
- AUTO-BYTE command is done, however, this tends to be
- unreliable as it is based on the mode used to write the
- file.
-
- The format of the command is:
-
- Kermit-10>SERVER
-
-
- *SET
- SET The SET command is used to set various parameters in Kermit.
- Additional information is available for the SET command by
- typing HELP SET <option>, where option is one of the
- following:
-
- BLOCK-CHECK-TYPE DEBUGGING DELAY
- ESCAPE FILE IBM INCOMPLETE-FILE
- HANDSHAKE LINE LOCAL-ECHO MESSAGE
- PARITY RECEIVE REPEAT RETRY
- SEND XON-XOFF-PROESSING
-
- *SET BLOCK-CHECK-TYPE
- SET BLOCK-CHECK-TYPE The SET BLOCK-CHECK-TYPE command is used to
- determine the type of block check sequence which will be
- used during transmission. The block check sequence is used
- to detect transmission errors. There are three types of
- block check available. These are the single character
- checksum (default), the two character checksum, and the
- three character CRC (cyclic redundancy check). This command
- does not ensure that the desired type of block check will be
- used, since both Kermit's involved in the transfer must
- agree on the block check type. Kermit-10 will request that
- the type of block check set by this command be used for a
- transfer. If the other Kermit has also had the same block
- check type requested, then the desired block check type will
- be used. Otherwise, the single character checksum will be
- used. (See Kermit protocol manual for more information.)
-
- Kermit-10>SET BLOCK-CHECK-TYPE keyword
-
- Where keyword is one of:
-
- 1. 1-CHARACTER-CHECKSUM or ONE-CHARACTER-CHECKSUM
-
- 2. 2-CHARACTER-CHECKSUM or TWO-CHARACTER-CHECKSUM
-
- 3. 3-CHARACTER-CRC-CCITT or THREE-CHARACTER-CRC-CCITT
-
-
- *SET DEBUGGING
- SET DEBUGGING The SET DEBUGGING command is used to set the
- debug type out on the user's terminal. Kermit-10 can only
- do debugging type out when running as a local Kermit (SET
- LINE command done). This is because the debugging type out
- would interfere with the file transfer if it were sent to
- the controlling terminal line in remote mode. The debugging
- log file may be used to redirect the debugging output to a
- file. This may be used with Kermit-10 running in either
- remote or local modes.
-
- Kermit-10>SET DEBUGGING keyword
-
- Where keyword is either ON, OFF, NO-LOG-FILE, or LOG-FILE
- file-specification. Doing a SET DEBUGGING LOG-FILE
- file-spec causes Kermit-10 to turn debugging on and append
- all debugging output to the file specified. If the file
- does not exist it will be created. SET DEBUGGING
- NO-LOG-FILE will close the log file and turn debugging off.
-
- *SET DELAY
- SET DELAY The DELAY parameter is the number of seconds to wait before
- sending data after a SEND command is given. This is used
- when Kermit-10 is running in remote mode to allow the user
- time to escape back to the other Kermit and give a RECEIVE
- command.
-
- Kermit-10>SET DELAY number-of-seconds
-
- Where number of seconds is the (decimal) number of second to
- wait before sending data.
-
- *SET ESCAPE
- SET ESCAPE This command will set the escape character
- for the CONNECT processing. The command will take the octal
- value of the character to use as the escape character. This
- is the character which is used to "escape" back to Kermit-10
- after using the CONNECT command. It defaults to ^Y (octal
- 31). It is usually a good idea to set this character to
- something which is not used (or at least not used very much)
- on the system being to which Kermit-10 is CONNECTing.
-
- Kermit-10>SET ESCAPE octal-character-value
-
- Where octal-character-value is the ASCII value of the
- character to use as the escape character (in octal).
-
- *SET FILE
- SET FILE This command allows the setting of various parameters
- dealing with file formats and file names. Additional
- information is available for the SET FILE command by typing
- HELP SET FILE <option>, where option is one of the
- following:
-
- BYTE-SIZE NAMING WARNING
-
- *SET FILE BYTE-SIZE
- SET FILE BYTE-SIZE This command sets the byte size Kermit-10
- will use for files being received or transmitted. SEVEN-BIT
- bytes should be used for ASCII text files which are to be
- used as text files on the TOPS-10 system. SEVEN-BIT should
- also be used to sending TOPS-10 format binary files to
- another system if the file is intended to be brought to a
- TOPS-10 system. EIGHT-BIT bytes should be used for binary
- files from other systems (such as CP/M .COM files) which are
- being transferred to the TOPS-10 system for storage. This
- allows the file to be returned without any changes.
- AUTO-BYTE is the same as SEVEN-BIT for files being received
- from the other Kermit. When sending a file with FILE
- BYTE-SIZE AUTO-BYTE, Kermit-10 will guess whether the file
- should be sent as SEVEN-BIT or EIGHT-BIT. This guess is
- based on the mode used to write the file. If the file was
- written in image mode, image binary mode, binary mode, or
- dump record mode, the file will be sent as an EIGHT-BIT
- file, otherwise it will be sent as a SEVEN-BIT file. Note
- that version 1 of Kermit-10 wrote all files it received in
- binary mode, even if FILE BYTE-SIZE SEVEN-BIT was set. This
- means that AUTO-BYTE will not correctly determine the byte
- size to use for files which were written with Kermit-10.
- This is also true of files written by a number of other
- programs under TOPS-10, most notably any file written by a
- Galaxy component (such as batch .LOG files) are written in
- binary mode. AUTO-BYTE is the default FILE BYTE-SIZE.
-
- Kermit-10>SET FILE BYTE-SIZE type
-
- Where type is SEVEN-BIT, EIGHT-BIT or AUTO-BYTE.
-
- *SET FILE NAMING
- SET FILE NAMING This command sets the type of processing
- Kermit should do on file names that are being sent and
- received. Kermit can either send the complete file
- specification (including device, directories, file name, and
- file extension or only the file name and extension. When
- receiving a file specification, Kermit can either attempt to
- use it as a TOPS-10 file specification as is, or first
- perform some substitutions and truncations in order to force
- the received specification to be just a valid file name and
- extension.
-
- Kermit-10>SET FILE NAMING keyword
-
- Where keyword is FULL, NORMAL-FORM, or UNTRANSLATED. FULL
- will cause Kermit to send the complete file specification
- for a file, and perform no substitutions on received file
- names. NORMAL-FORM will cause Kermit to send only the file
- name and extension with "X"s substituted for
- non-alphanumeric characters, and substitute "X"'s for
- non-alphanumeric characters in received file specifications
- to force them to be only a file name an extension.
- UNTRANSLATED will cause Kermit to send only the file name
- and extension (with no substitution) and perform no
- substitutions on received file names.
-
- *SET FILE WARNING
- SET FILE WARNING This command determines what Kermit-10 will
- do when it receives a file with a file name that already
- exists. If FILE WARNING is turned ON, Kermit-10 will not
- supersede the old file. Instead it will create a file with
- the same file name and the first extension of the form .nnn
- (where n is an octal digit) such that the file will not
- supersede any existing file. If FILE WARNING is turned OFF
- (the default), Kermit-10 will supersede the old file.
-
- Kermit-10>SET FILE WARNING keyword
-
- Where keyword is either ON or OFF.
-
- *SET HANDSHAKE
- SET HANDSHAKE This command allows the user to set up
- the IBM handshaking character to whatever character is
- prefered
-
- Kermit-10>SET HANDSHAKE n
-
- Where n is a decimal number between 0 and 127
-
- *SET IBM
- SET IBM The SET IBM command allows Kermit-10 to
- be put into a mode which will allow transfers to an IBM
- host. This causes Kermit-10 to wait for the IBM turnaround
- character (XON, CTRL-Q) before sending any characters to the
- other Kermit. It also forces the parity type to be mark,
- turns on local echo, and sets the handshake character to ctrl-q
- for the CONNECT command.
-
- Kermit-10>SET IBM
-
-
- *SET INCOMPLETE-FILE
- SET INCOMPLETE-FILE The SET INCOMPLETE-FILE command allows the
- user to determine what is done with a file that is not
- completely received. If the disposition is KEEP, all file
- received will be kept, even if only a portion of the file is
- received. If the disposition is DISCARD (the default),
- files which are not completely received are discarded.
-
- Kermit-10>SET INCOMPLETE-FILE keyword
-
- Where keyword is either DISCARD or KEEP.
-
- *SET LINE
- SET LINE This will set the terminal line that Kermit-10 will use for
- file transfers and the CONNECT command.
-
- Kermit-10>SET LINE device:
-
- Where device: is a terminal name.
-
- or
-
- Kermit-10>SET LINE node:: line
-
- Where node:: is the node name the terminal is physically
- connected to, and line number is the terminals line number
- within that node.
-
- *SET LOCAL-ECHO
- SET LOCAL-ECHO The SET LOCAL-ECHO command specifies whether
- characters should be echoed locally when CONNECTing to
- another system. If LOCAL-ECHO is set to ON, any character
- typed on the terminal will be echoed immediately to the
- terminal, as well as being sent to the other system. If
- LOCAL-ECHO is set to OFF (the default), the characters typed
- on the terminal are only sent to the other system (which
- would normally be echoing the characters).
-
- Kermit-10>SET LOCAL-ECHO keyword
-
- Where keyword is either ON or OFF.
-
- *SET MESSAGE
- SET MESSAGE This command sets the type of typeout
- Kermit-10 will do during transfers in local mode. Kermit-10
- can type out the file specification being transferred, the
- packet numbers being sent an received, both or neither. The
- default is to type file specifications but not packet
- numbers.
-
- Kermit-10>SET MESSAGE type
-
- or
-
- Kermit-10>SET MESSAGE NO type
-
- Where type is either FILE or PACKET.
-
- *SET PARITY
- SET PARITY This command determines the type of parity to
- use on the transmission line. Kermit normally uses
- characters which consist of eight data bits with no parity
- bit. For systems or transmission media which require a
- specific parity type, Kermit can send characters as seven
- data bits plus a parity bit.
-
- Kermit-10>SET PARITY keyword
-
- Where keyword is one of:
-
- 1. NONE (default) - eight data bits and no parity bit.
-
- 2. MARK - seven data bits with the parity bit set to one.
-
- 3. SPACE - seven data bits with the parity bit set to zero.
-
- 4. EVEN - seven data bits with the parity bit set to make
- the overall parity even.
-
- 5. ODD - seven data bits with the parity bit set to make
- the overall parity odd.
-
-
- *SET RECEIVE
- SET RECEIVE It is possible to set various parameters
- associated with the receiving of the data from the remote
- Kermit. SET RECEIVE will enable you to set the various
- receive parameters. Additional information is available for
- the SET RECEIVE commands by typing HELP SET RECEIVE
- <option>, where <option> is one of the following:
-
- EIGHTH-BIT-QUOTE END-OF-LINE PACKET-LENGTH
- PADCHAR PADDING QUOTE
- START-OF-PACKET TIMEOUT
-
- *SET RECEIVE EIGHTH-BIT-QUOTE
- SET RECEIVE 8TH-BIT-QUOTE or
- SET RECEIVE EIGHTH-BIT-QUOTE This command sets the
- character to be used (when necessary) to quote characters
- which have the eighth bit (parity bit) set. This is used to
- transfer eight-bit bytes on a transmission medium which only
- supports seven data bits. The default value is 46 (ASCII
- "&"). Eighth-bit quoting will only be used if both Kermit's
- can handle it, and the tranmission medium does not transmit
- 8 data bits (as indicated by the SET PARITY command).
-
- Kermit-10>SET RECEIVE EIGHTH-BIT-QUOTE nnn
-
- Where nnn is the ASCII value of the character (in octal) to
- use for quoting characters which have the eighth bit set.
-
- *SET RECEIVE END-OF-LINE
- SET RECEIVE END-OF-LINE This will set the end of line character that
- Kermit-10 expects to receive from the remote Kermit. This
- is the character which terminates a packet. The default
- value is 15 (ASCII CR, CTRL-M).
-
- Kermit-10>SET RECEIVE END-OF-LINE nnn
-
- Where n is the ASCII value of the character to use for the
- end of line character (in octal).
-
- *SET RECEIVE PACKET-LENGTH
- SET RECEIVE PACKET-LENGTH This will set the receive
- packet length. The value for this parameter must be between
- 10 and 96. Packet lengths outside of this range are
- illegal. The default value is 80.
-
- Kermit-10>SET RECEIVE PACKET-LENGTH 60
-
- *SET RECEIVE PADCHAR
- SET RECEIVE PADCHAR This parameter is the padding character that
- is expected by Kermit-10. The parameter must be an octal
- number in the range of 0 to 37 or 177. All other values are
- illegal. The default value is 0 (an ASCII NUL). Kermit-10
- does not normally need any padding characters.
-
- Kermit-10>SET RECEIVE PADCHAR nnn
-
- Where nnn is the ASCII value of the character to be used as
- a pad character (in octal).
-
- *SET RECEIVE PADDING
- SET RECEIVE PADDING This command will set the number of padding
- characters that are expected by Kermit-10. The default
- value is 0.
-
- Kermit-10>SET RECEIVE PADDING n
-
- Where n is the decimal number of padding characters to use.
-
- *SET RECEIVE QUOTE
- SET RECEIVE QUOTE This will set the quoting character that
- Kermit-10 will expect on incoming messages. This is the
- character used to quote control characters. The default
- value is 43 (ASCII "#").
-
- Kermit-10>SET RECEIVE QUOTE nnn
-
- Where nnn is the ASCII value of the quoting character (in
- octal).
-
- *SET RECEIVE START-OF-PACKET
- SET RECEIVE START-OF-PACKET This command will set the
- start of packet character for Kermit. The start of packet
- character must be in the range of 0 to 36 octal. The
- default value is 1 (ASCII SOH, CTRL-A). This value should
- only be changed if absolutely necessary. It must be set the
- same in both Kermit's.
-
- Kermit-10>SET RECEIVE START-OF-PACKET 3
-
- *SET RECEIVE TIMEOUT
- SET RECEIVE TIMEOUT This will set the number of seconds before
- Kermit-10 will request that the other Kermit wait when
- attempting to receive a message. This time out is used to
- handle transmission errors which totally lose a message.
- The default value is 15 seconds.
-
- Kermit-10>SET RECEIVE TIMEOUT n
-
- Where n is the number of seconds to wait for a message (in
- decimal).
-
- *SET REPEAT
- SET REPEAT This command sets the character to be used as
- the lead-in character for a repeat sequence (a string of
- characters which represents some number of characters which
- are repeated in the data). Both Kermit's must support
- repeat compression for this to be in effect. The character
- set by this command must be in the range 41 ("1") to 76
- (">") or 140 ("`") to 176 ("~"). The character will only be
- used on file which are being transmitted by Kermit-10. The
- REPEAT character used for incoming files is decided on by
- the other Kermit. The default value is 176 ("~"). A value
- of 40 (a space) will disable repeat compression.
-
- Kermit-10>SET REPEAT nnn
-
- Where nnn is the ASCII value for the repeat quoting
- character (in octal).
-
- *SET RETRY
- SET RETRY This command sets the maximum number of times Kermit-10
- should try to send specific packet. There are two retry
- maximums, one for the initial connection packet (the
- "SEND-INIT"), the other for all other packets. The default
- value for initial connections is 5. The default value for
- all other packets is 16.
-
- Kermit-10>SET RETRY keyword n
-
- Where keyword is either INITIAL-CONNECTION (for initial
- connection packet) or PACKETS (for all other packets), and n
- is the decimal number of retries to attempt.
-
- *SET SEND
- SET SEND It is possible to set various parameters associated with the
- sending of data to the remote Kermit. SET SEND will enable
- you to set the various SEND parameters. These parameters
- should not normally be set, since, as part of the transfer
- initialization process, the two Kermit's exchange their
- RECEIVE parameters. The capability of setting these
- parameters is provided so that the transfer initialization
- can be completed even if the default parameters are not
- correct. Additional information is available for the SET
- SEND command by typing HELP SET SEND <option>, where
- <option> is one of the following:
-
- END-OF-LINE PACKET-LENGTH PADCHAR PADDING QUOTE
- START-OF-PACKET TIMEOUT
-
- *SET SEND END-OF-LINE
- SET SEND END-OF-LINE This will set the end of line character the
- Kermit-10 will send to the remote Kermit. This is the
- character which terminates a packet. The default value is
- 15 (ASCII CR, CTRL-M).
-
- Kermit-10>SET SEND END-OF-LINE nnn
-
- Where n is the ASCII value of the character to use for the
- end of line character (in octal).
-
- *SET SEND PACKET-LENGTH
- SET SEND PACKET-LENGTH This will set the SEND packet length. The
- value for this parameter must be between 10 and 96. Packet
- lengths outside of this range are illegal. The default
- value is 80.
-
- Kermit-10>SET SEND PACKET-LENGTH 60
-
- *SET SEND PADCHAR
- SET SEND PADCHAR This parameter is the padding character that
- is sent to the remote Kermit. The parameter must be an
- octal number in the range of 0 to 37 or 177. All other
- values are illegal. The default value is 0 (an ASCII NUL).
-
- Kermit-10>SET SEND PADCHAR nnn
-
- Where nnn is the ASCII value of the character to be used as
- a pad character (in octal).
-
- *SET SEND PADDING
- SET SEND PADDING This command will set the number of padding
- characters that will be sent to the other Kermit. The
- default value is 0.
-
- Kermit-10>SET SEND PADDING n
-
- Where n is the decimal number of padding characters to use.
-
- *SET SEND QUOTE
- SET SEND QUOTE This will set the quoting character that
- Kermit-10 will expect on incoming messages. This is the
- character used to quote control characters. The default
- value is 43 (ASCII "#").
-
- Kermit-10>SET SEND QUOTE nnn
-
- Where nnn is the ASCII value of the quoting character (in
- octal).
-
- *SET SEND START-OF-PACKET
- SET SEND START-OF-PACKET This command will set the start of packet
- character for Kermit. The start of packet character must be
- in the range of 0 to 36 octal. The default value is 1
- (ASCII SOH, CTRL-A). This value should only be changed if
- absolutely necessary. It must be set the same in both
- Kermit's.
-
- Kermit-10>SET SEND START-OF-PACKET 3
-
- *SET SEND TIMEOUT
- SET SEND TIMEOUT This will set the number of seconds before
- Kermit-10 will time out a message it has sent to the other
- Kermit. message. This time out is used to handle
- transmission errors which totally lose a message. The
- default value is 15 seconds.
-
- Kermit-10>SET SEND TIMEOUT n
-
- Where n is the number of seconds to wait for a message (in
- decimal).
-
- *SET XON-XOFF-PROCESSING
- SET XON-XOFF-PROCESSING This will set the XON-XOFF-processing
- mode to DEFAULT, LOCAL, or REMOTE. This determines who
- will handle the parsing of CNTRL-Q and CNTRL-S's.
-
- Kermit-10>SET XON-XOFF-PROCESSING keyword
-
- Where keyword is either DEFAULT, LOCAL, or REMOTE
-
- *SHOW
- SHOW The SHOW command will allow you to show the various
- parameters that are set with the SET command. Additional
- information is available for the SHOW command by typing HELP
- SHOW <option>, where <option> is one of the following:
-
- ALL DAYTIME DEBUGGING FILE-INFORMATION
- LINE-INFORMATION PACKET-INFORMATION
- VERSION
-
- *SHOW ALL
- SHOW ALL The SHOW ALL command will cause all of the parameters to be
- listed.
-
- *SHOW DAYTIME
- SHOW DAYTIME Display the current date and time.
-
- *SHOW DEBUGGING
- SHOW DEBUGGING Display whether debugging is enabled, the
- current debugging log file (if any), and the message type
- out information.
-
- *SHOW FILE-INFORMATION
- SHOW FILE-INFORMATION This will display the parameters related to
- files being used. This includes the file byte size and the
- incomplete file disposition.
-
- *SHOW LINE-INFORMATION
- SHOW LINE-INFORMATION Display the terminal line being used, the
- parity being used and whether local echo is enabled.
-
- *SHOW PACKET-INFORMATION
- SHOW PACKET-INFORMATION This will display the current settings of the
- send and receive packet parameters.
-
- *SHOW VERSION
- SHOW VERSION Display the version number of Kermit-10.
-
- *STATUS
- STATUS The current status of Kermit-10 will be displayed. This
- includes the number of characters that have been sent and
- received from the remote Kermit. Also included is an
- estimate of the effective baud rate of the transfer. This
- number is not intended to be exact, but only an indication
- of what range of throughput has been provided.
-